单文件上传

addFile('name值', '标题' [, '提示', '默认值', '限制大小', '文件后缀', '额外css类'])" class="reference-link">addFile('name值', '标题' [, '提示', '默认值', '限制大小', '文件后缀', '额外css类'])

标识符：file

简单例子" class="reference-link">简单例子

return ZBuilder::make('form')
    ->addFile('file', '文件')
    ->fetch();

效果：

默认值" class="reference-link">默认值

默认值是附件id，不要填写文件地址

限制大小

默认可以不同填写大小限制，可以在后台，“系统” -> “系统设置” -> “上传”设置。

如果在某些情况下，需要重新定义，可以填写此参数，大小为kb，比如限制上传大小为1mb。

return ZBuilder::make('form')
    ->addFile('file', '文件', '', '', '1024')
    ->fetch();

文件后缀" class="reference-link">文件后缀

跟限制大小一样，可以在后台“系统” -> “系统设置” -> “上传”设置。

也可以重新定义

return ZBuilder::make('form')
    ->addFile('file', '文件', '', '', '1024', 'zip,7z')
    ->fetch();

自定义js回调" class="reference-link">自定义js回调

从1.0.5版本开始，可通过自定义js回调函数来处理上传成功之后，或者上传失败之后需要做的事情，比如：

return ZBuilder::make('form')
    ->addFile('file', '文件')
    ->js('test') // 引入自定义的外部js文件
    ->fetch();

然后在test.js中定义

var dp_file_upload_success = function () {
  console.log(1111)
};

那么在文件上传成功后，会执行dp_file_upload_success函数，在控制台输出1111.当然了，你也可以利用jQuery给表单添加个按钮，或者显示隐藏某些元素，这个按自己实际需求做就可以了。

dp_file_upload_success函数是针对表单中的所有文件上传组件，包括单文件上传，多文件上传，也就是说，不管你的表单中添加了多少个文件上传组件，每次上传成功，都会去执行dp_file_upload_success函数。

如果只想某个文件上传组件上传成功时才触发dp_file_upload_success函数，可以这么做。

return ZBuilder::make('form')
    ->addFile('file1', '文件1')
    ->addFile('file2', '文件2')
    ->js('test') // 引入自定义的外部js文件
    ->fetch();

test.js代码如下：

var dp_file_upload_success_file2 = function () {
  console.log(1111)
};

这样的话，只有当file2这个组件上传文件成功后才会触发dp_file_upload_success_file2函数。而当file1组件上传文件成功后，是不会触发dp_file_upload_success_file2函数的。

除了dp_file_upload_success函数外，还支持以下回调函数。